NAG Data Mining Components, Release 1

DRSOL10DA

Sun SPARC (Solaris)

Users' Note



Contents


1. Introduction

This document is essential reading for every user of the NAG Data Mining Components implementation specified in the title. It provides implementation-specific detail that augments the information provided in the online documentation.

2. Availability of Functions

All 36 functions identified in the file Documents/clist.html are available in this implementation. Your suggestions for new algorithms for inclusion in future releases of the NAG Data Mining Components are welcomed (see Section 5).

3. General Information

3.1. Accessing the NAG Data Mining Components

Assuming that libnag_dmc.a has been installed in a directory in the search path of the linker, such as /usr/lib, and that the NAG Data Mining Components include files have been moved to /usr/include, then you may link to the NAG Data Mining Components in the following manner: 

cc -o driver.exe driver.c -lnag_dmc -lsocket -lnsl -lintl -lm
where driver.c is your application program. If the Components are in a location other than /usr/lib, such as /opt/NAG/lib, and the include files are in a location other than /usr/include, such as /opt/NAG/include, then you may link to the NAG Data Mining Components in the following manner: 
cc -o driver.exe -I/opt/NAG/include driver.c -L/opt/NAG/lib -R/opt/NAG/lib \
                                    -lnag_dmc -lsocket -lnsl -lintl -lm
The use of the -L and -R options in the compilation command can be avoided if the environment variable LD_LIBRARY_PATH is set as follows: 
setenv LD_LIBRARY_PATH /opt/NAG/lib
(see the man page for ld(1) for more information about LD_LIBRARY_PATH).

3.2. Example Programs

A number of example programs are provided in the directory Examples. Some of these examples refer to data files, consequently users should check that the file name is appropriate for their system before compiling the source text. Furthermore, for the example programs named in the following table one additional file must be compiled and linked in order to build an executable program.

Example File Additional File Needed
basic_logistic_exf.c iris_sp.c
dt_exf.c df_iris.c
hclust_exf.c iris.c
kmeans_exf.c iris.c
knnc_exf.c df_iris.c
knnp_exf.c df_iris.c
logistic_exf.c iris_sp.c
pca_exf.c iris.c
regr_exf.c iris_sp.c

In order to compile and link an example, say pca_exf.c, then copy the source files from the directory Examples to your current directory. Examine the source to see whether a data file is required. If it is then copy the data file from the directory Examples to the current directory and modify the source text to reflect the local file name.

Issue the compilation command 

cc -o pca_exf.exe iris.c pca_exf.c -lnag_dmc -lsocket -lnsl -lintl -lm

This command will create an executable file called pca_exf.exe.

The exception to this is the ODBC example contained in file odbc_ex.c. This example requires that some ODBC software is installed on your system as well as the NAG Data Mining Components. To compile and link this example copy the files to your current directory as described above. If you have unixODBC installed in a directory on the linker's search path you can compile and link this example by issuing the command 

cc -o odbc_ex.exe odbc_ex.c -lnag_dmc -lodbc -lsocket -lnsl -lintl -lm

3.3. User Documentation

Full documentation is provided online. The documentation comprises HTML and PDF files, the root of which is file nag_dmc_intro.html. You should check how these files have been made available locally. Please note that if you do not have a pdf viewer available then the Adobe Acrobat Reader can be downloaded free of charge from the Adobe Web site at http://www.adobe.com/.

4. Support from NAG

(a) How to Contact NAG

If you have any queries concerning the use of this product please contact NAG directly using one of the methods given below.

(b) NAG Response Centres

The NAG Response Centres are available for general enquiries from all users and also for technical queries from sites with an annually licensed product or support service.

The Response Centres are open during office hours, but contact is possible by fax, email and phone (answering machine) at all times.

When contacting a Response Centre please quote your NAG site reference and NAG product code (in this case DRSOL10DA).

(c) NAG Websites

The NAG websites are an information service providing items of interest to users and prospective users of NAG products and services. The information is reviewed and updated regularly and includes implementation availability, descriptions of products, downloadable software, product documentation and technical reports. The NAG websites can be accessed at

http://www.nag.co.uk/

or

http://www.nag.com/ (in North America)

or

http://www.nag-j.co.jp/ (in Japan)

(d) NAG Electronic Newsletter

If you would like to be kept up to date with news from NAG you may want to register to receive our electronic newsletter, which will alert you to special offers, announcements about new products or product/service enhancements, case studies and NAG's event diary. To register visit one of our websites or contact us at nagnews@nag.co.uk.

5. User Feedback

Many factors influence the way NAG's products and services evolve and your ideas are invaluable in helping us to ensure that we meet your needs. If you would like to contribute to this process we would be delighted to receive your comments by email at feedback@nag.co.uk. Alternatively contact the appropriate NAG Response Centre who will be happy to record your comments.

Appendix - How to Contact NAG

NAG Ltd
Tel: +44 (0)1865 511245
Fax: +44 (0)1865 310139   
                               
NAG Ltd Response Centre
email: support@nag.co.uk
Tel: +44 (0)1865 311744
Fax: +44 (0)1865 310139
 
NAG Inc
Tel: +1 630 971 2337 
Fax: +1 630 971 2706                    
                   
NAG Inc Response Center
email: infodesk@nag.com
Tel: +1 630 971 2345
Fax: +1 630 971 2706
 
Nihon NAG KK
Tel: +81 (0)3 5542 6311
Fax: +81 (0)3 5542 6312

email: help@nag-j.co.jp


[NP3627/UN]